home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / spitfire / dstats20.zip / DLXSTAT.DOC < prev    next >
Text File  |  1993-03-27  |  10KB  |  272 lines
  1.  
  2.  
  3.  
  4.                         DELUXE STATISTICS v2.00
  5.  
  6.                       (C) 1992, 1993 by Isto Havu
  7.  
  8.  
  9.  
  10.  
  11.   DESCRIPTION
  12.   -----------
  13.  
  14. Deluxe Statistics v2.0 is the BEST program available to create
  15. statistical COLOR bulletins for your BBS. Deluxe Statistics will quickly
  16. read Callers.log and Sfusers.dat (which are created by SpitFire), and
  17. create eight (yes, eight!) different screens with amazing beautiful
  18. graphics and lots of statistical informations. Deluxe Statistics will
  19. work on any SpitFire based system, no matter which modem you have, no
  20. matter which monitor you have etc. Deluxe Statistic is a very powerful
  21. program, which does not need much time to fill it's duty. You don't
  22. anymore have to have 8 different programs, just one.. Just once to read
  23. the important files, and it's all done.
  24.  
  25. It should be noted, that SpitFire BBS is programmed (C) by Mike Woltz,
  26. and that SpitFire is the BEST BBS available.
  27.  
  28.  
  29.   $HAREWARE
  30.   ---------
  31.  
  32. Deluxe Statistics is a shareware program. It is not public domain, it is
  33. not free. You may test it for two weeks, and maybe ask your users how
  34. they like it. But then.. if (or better WHEN) you keep on using it after
  35. those two weeks, you are REQUIRED to pay the registration fee (=buy the
  36. program) of US$ 10. It may sound much, but it's much only for me, not
  37. for you. Think how much cost your modem.. Think how much cost 10
  38. diskettes.. And think how much you use this program, every day once? I
  39. have spent hours and days and months to build up this program, so I
  40. think it's not much asked. When you pay the registration, you may use
  41. all the future versions of this program FREE. And when you send me $10,
  42. you make me really happy and encourage me to develop Deluxe Statistics
  43. and other programs.
  44.  
  45.  
  46.   HOW DOES IT DESTROY MY HARDWARE?
  47.   --------------------------------
  48.  
  49. I did NOT write a program, which blows up your monitor and formats your
  50. HD. NO! It has done well on my system for months, without ANY problems.
  51. I do NOT think, that it could ANYWAY be able to destroy ANYTHING. But IF
  52. something unexpedient happens, it is not may fault, I am not and I will
  53. not be responsible, YOU are.
  54.  
  55.  
  56.   REQUIREMENTS
  57.   ------------
  58.  
  59. ■ SpitFire BBS v3.3 (or later)
  60. ■ 100% IBM Compatible System
  61. ■ 72k of free RAM
  62.  
  63. Deluxe Statistics is written for SpitFire BBS v3.3. It does not work
  64. with SpitFire v3.2 (or older) properly.
  65.  
  66. When newer versions of SpitFire will be published, Deluxe Statistics
  67. will quickly be updated to work (also) with them.
  68.  
  69. When you run the program, it first tells you how much RAM you have left.
  70. It's not very important, but I hope this will help you to configure your
  71. system in some difficult cases.
  72.  
  73.  
  74.   FILES IN THE PACKET
  75.   -------------------
  76.  
  77. The packet (DSTATS20.ZIP) should contain the following files, the sizes,
  78. dates etc. should be EXACTLY as below. (If they aren't, someone MAY have
  79. modified the program without a permission. In that case, it is not even
  80. a good idea to try how it works.. there may be viruses or some other
  81. funny things..)
  82.  
  83.         Name.ext        Size       Date        Time
  84.  
  85.         DLXSTAT.EXE     30736      03-27-93    02:00
  86.         DLXSTAT.DOC      9965      03-27-93    02:00
  87.         DLXSTAT.CFG        76      03-27-93    02:00
  88.         EXAMPLE.BBS      9165      03-27-93    02:00
  89.         EXAMPLE.CLR     10607      03-27-93    02:00
  90.         REGISTER.FRM     1833      03-27-93    02:00
  91.         FILE_ID.DIZ       180      03-27-93    02:00
  92.         --------------------------------------------
  93.         Total           62562
  94.  
  95. DLXSTAT.EXE is the main program. It may NOT be modified anyway.
  96.  
  97. DLXSTAT.CFG is the configuration file. It should always be in the same
  98. directory with Dlxstat.exe. The configuration is explained in the
  99. Installing Deluxe Statistics -paragraph.
  100.  
  101. DLXSTAT.DOC is this file. After you have read it and understood
  102. everything, you may delete it. The program does not require it to run.
  103. But keep it in a safe place, so if there comes problems, you can solve
  104. them.
  105.  
  106. EXAMPLE.BBS is an example bulletin with no ansi codes. Deluxe Statistics
  107. will create something like this, when you run it.
  108.  
  109. EXAMPLE.CLR is another example bulletin, but this time with ansi codes
  110. and with COLORS. Deluxe Statistics will also create this one,
  111. automatically.
  112.  
  113. REGISTER.FRM is the registration form. When you have somehow got $10,
  114. you can print this on a paper, and send it with the money to me. If you
  115. don't have a printer, you also can write the same informations on a
  116. paper with your own hands, and then send that paper.. AND the money.
  117.  
  118. FILE_ID.DIZ is important only for BBSes. You may remove it, but it has
  119. to be included - as all of the files - in the packet distributed. It
  120. includes the file description for Dstats20.zip.
  121.  
  122.  
  123.   INSTALLING
  124.   ----------
  125.  
  126. ■ DIRECTORY / FILES
  127.  
  128. First copy all Dlxstat.* files to any directory on your HD. You may copy
  129. them to your SpitFire Work directory, but you can also create a new
  130. directory for them. If the program is in the Work directory, it will run
  131. faster.
  132.  
  133.  
  134. ■ DLXSTAT.CFG - CONFIGURATION
  135.  
  136. Then you must configure and edit Dlxstat.cfg. It should look something
  137. like this:
  138.  
  139. NAME OF YOUR BBS
  140. C:\SF\WORK\
  141. C:\SF\DISPLAY\BULLET1
  142. #1 #2 #76
  143.  
  144. On the first line should be the name of your BBS.
  145.  
  146. On the second line the Work directory of your SpitFire OR the directory,
  147. where you have the necessary files created by SpitFire (Callers.log and
  148. Sfusers.dat). If you don't know it, you can check it by pressing Alt-P
  149. in SpitFire Ready prompt. Remember, that there MUST be the '\' in the
  150. end of the line. Although you would have the program in the same
  151. directory, you MUST write the complete path.
  152.  
  153. On the third line should be the address for the display files created by
  154. Deluxe Statistics. Also here complete path is necessary, also the name
  155. of the files. BUT the extension (.CLR and .BBS) is not needed, and you
  156. should not even write it. Deluxe Statistics automatically creates both
  157. color and non-color screens.
  158.  
  159. The fourth line contains the users, you don't want to get to the top 15
  160. lists. Such users could be the SysOp of the BBS (you) and the CoSysOp.
  161. Just check the record numbers of these users by pressing Alt-A in
  162. SpitFire Ready prompt, and write them here. Remember that you MUST put a
  163. '#' in front of the numbers, as in the example.
  164.  
  165.  
  166. ■ RUNNING FOR THE FIRST TIME - IMPORTANT!!
  167.  
  168. Now type Dlxstat in the right directory, and Deluxe Statistics will run
  169. for the first time. If the configured display files do not exist yet,
  170. there will be a run-time error, and everything will be aborted. Deluxe
  171. Statistics creates two display files, but only the names, the size will
  172. be 0 bytes. This is because you have to have the oppoturnativ to check
  173. the configuration. The next time you run the program, everything will be
  174. OK and the files will be created.
  175.  
  176. DO NOT ERASE the old display files, or you have to run Deluxe Statistics
  177. twice to create new ones. If Deluxe Statistics finds the old display
  178. files, it will also create new ones.
  179.  
  180. Now Deluxe Statistics is ready to run. Just type DLXSTAT in the right
  181. directory - and new bulletins will be created.
  182.  
  183.  
  184. ■ USING DELUXE STATISTICS AS AN EVENT
  185.  
  186. First edit your Sf.bat so, that it will run Deluxe Statistics in some
  187. event. The part of your Sf.bat could look something like this:
  188.  
  189. :EVENT_A
  190.   CD\SF\EVENT_A
  191.   DLXSTAT
  192.   GOTO LOOP
  193.  
  194. Then go back to SpitFire, and press Alt-E. Now you must enable the
  195. event, in which you put Deluxe Statistics (if you didn't put it to some
  196. event, which already is enabled). It's a good idea to run this event
  197. every day. And the best time is just after midnight, in other words at
  198. 00:01. This event does not have to be an On-Time Event. Of course you
  199. also can run this event at 04:00 in the morning, when there aren't any
  200. calls, but many doors require some maintenance at midnight, so it's easy
  201. to run Deluxe Statistics at the same time.
  202.  
  203.  
  204.   USING DELUXE STATISTICS
  205.   -----------------------
  206.  
  207. I hope that you find Deluxe Statistics as useful as I do. It really is a
  208. succesful collection, which includes all the existing and non-existing
  209. statistics for SpitFire BBSes. It's ease to use and easy to configure.
  210. It's fast and flexible.
  211.  
  212. But remember: I spent hours, days, weeks and months to program and
  213. develop Deluxe Statistics. I didn't do it just for myself, I gave also
  214. you a try.. If you like it, please buy it - don't steal it.
  215.  
  216. After 2 weeks use please pay the registration, and I'll get the signal
  217. and thank you. If I know that people use my program, I'll continue my
  218. work and make it even better - new versions with new ideas..
  219.  
  220. Please fill in Register.frm, and send it with registration fee. Also any
  221. comments and ideas are REALLY welcome.
  222.  
  223. My address is:
  224.  
  225.         Isto Havu
  226.         Urheilukatu 24 A 4
  227.         00250 Helsinki
  228.         Finland, Europe
  229.  
  230.  
  231.   BUG FIXES & ADDITIONS
  232.   ---------------------
  233.  
  234.   >>> v2.00:
  235.  
  236.   o Deluxe Statistics fixed to support SpitFire v3.3
  237.  
  238.   o Top 15 Message Writers screen included
  239.  
  240.   o Some screens fixed
  241.  
  242.   o Amount of lines in every screen now correct
  243.  
  244.   o Clear Screen added                         
  245.  
  246.   o Minor improvements
  247.  
  248.  
  249.   >>> v1.02:
  250.  
  251.   o First published version of Deluxe Statistics
  252.  
  253.   o Positions of Top 15 -users are now clearly written
  254.  
  255.   o Now all the screens are on their correct position and contain the
  256.     right amount of lines
  257.  
  258.  
  259.   >>> v1.01:
  260.  
  261.   o Deluxe Statistics will now self check the speeds of the calls. The
  262.     statistics will contain only the existing speeds, in other words the
  263.     speeds from the lowest speed to the highest speed
  264.  
  265.   o The dates and times on the bulletins will now be written correctly,
  266.     although they would contain 0's
  267.  
  268.   o Some dark colors removed from the color bulletins, for example the
  269.     dark blue, which are hard to see
  270.  
  271.  
  272.